home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / pibt32s1.arc / SREADME.DOC < prev   
Encoding:
Text File  |  1985-11-30  |  6.6 KB  |  199 lines
  1. INTRODUCTION TO PIBTERM v3.2.5 SOURCE CODE
  2. ==========================================
  3.  
  4. The four archive libraries
  5.  
  6.      PIBT32S1.ARC
  7.      PIBT32S2.ARC
  8.      PIBT32S3.ARC
  9.      PIBT32S4.ARC
  10.  
  11. contain TURBO Pascal routines which implement a terminal emulation
  12. and host communications program called PibTerm.
  13.  
  14. This is version 3.2.5 of Pibterm, released November 30, 1985.
  15.  
  16. Features of PibTerm version 3.2.5 include:
  17.  
  18.    1.  Several different terminal emulation methods:
  19.  
  20.           -- DEC VT52
  21.           -- DEC VT100 (large subset)
  22.           -- BBS ANSI  (ANSI.SYS color graphics and music)
  23.           -- Dumb glass TTY
  24.           -- Dumb glass TTY in split-screen mode
  25.  
  26.    2.  The ability to act as a host program (mini BBS).
  27.  
  28.    3.  Ring buffered, interrupt driven, serial I/O.
  29.  
  30.    4.  A number of popular file transfer methods:
  31.  
  32.           -- Xmodem Checksum and CRC
  33.           -- Modem7 batch with either Checksum or Crc
  34.           -- Ymodem batch or single file
  35.           -- Telink
  36.           -- Kermit
  37.           -- CompuServe "B" Protocol
  38.           -- Ascii with XON/XOFF
  39.           -- Autodownload Xmodem for Bob Mahoney's EXEC PC BBS.
  40.  
  41.    5.  Telephone dialing directory.
  42.  
  43.    6.  Session logging/capture to printer and/or disk.
  44.  
  45.    7.  On-screen editing (block mode) for use with mainframes.
  46.  
  47.    8.  Menu-driven commands.
  48.  
  49.    9.  Macro-key definition, with sufficient capability to
  50.        provide auto-logon scripts.
  51.  
  52.   10.  Escapes to the operating system (and return from DOS)
  53.        within a PibTerm session.
  54.  
  55.   11.  Built-in file and directory manipulation, including
  56.        directory display, file display, file copying, file erasure.
  57.  
  58.   12.  Screen dumps to a file.
  59.  
  60.   13.  Customizable modem support.
  61.  
  62.   14.  Automatic change of baud rate to the proper one with
  63.        smart modems like the Hayes 1200 and USR Courier.
  64.  
  65.   15.  Built-in phone area code directory.
  66.  
  67.   16.  Review buffer for lines scrolled off top of screen.
  68.  
  69.   17.  Easy alteration of program parameters to customize to
  70.        a particular system.
  71.  
  72.   18.  Extensive script facility for automating communications chores.
  73.  
  74. These archive libraries were created using ARC450.EXE.  I assume
  75. that if you are reading this file, then you have the proper version
  76. of ARC!
  77.  
  78.  
  79. DOCUMENTATION AND EXECUTABLE VERSION
  80. ====================================
  81.  
  82. The files PIBT32S1.ARC through PIBT32S4.ARC contain only the source
  83. to PibTerm version 3.2.5.  The ready-to-use executable version,
  84. complete documentation, and configuration files are available in the
  85. archive files PIBT32E1.ARC, PIBT32E2.ARC, and PIBT32E3.ARC.
  86.  
  87. CHECKING ARCHIVE'S INTEGRITY
  88. ============================
  89.  
  90. If you downloaded the files PIBT32S1.ARC through PIBT32S4.ARC
  91. from a BBS system, rather than getting them directly on disk,
  92. it's a good idea to verify the integrity of those files using
  93. the integrity check feature of ARC450.  To perform the check, enter:
  94.  
  95.      ARC450 T PIBT32S1.ARC
  96.      ARC450 T PIBT32S2.ARC
  97.      ARC450 T PIBT32S3.ARC
  98.      ARC450 T PIBT32S4.ARC
  99.  
  100. If the archives pass the integrity check, then you can proceed
  101. to extract the files as shown below.  If an archive is bad, you
  102. can either try downloading it again (although the file may be
  103. bad on the BBS you called), or write me for the source + executables
  104. disks as described below.
  105.  
  106.  
  107. COMPILING PIBTERM
  108. =================
  109.  
  110. First of all, you need about 2 megs of disk space to compile PibTerm.
  111. You will also need Turbo Pascal version 3.0 or later.
  112.  
  113. To compile PibTerm, extract all the .PAS files from the archive
  114. files.  You do this by saying:
  115.  
  116.      ARC450 E PIBT32S1.ARC *.*
  117.      ARC450 E PIBT32S2.ARC *.*
  118.      ARC450 E PIBT32S3.ARC *.*
  119.      ARC450 E PIBT32S4.ARC *.*
  120.  
  121. Enter Turbo by issuing the TURBO command to DOS.
  122.  
  123. Next, enter O for O)ptions and set Turbo to write a .COM file
  124. by entering a C.  Also set the maximum heap space using A to
  125. 2000H.  This is necessary to ensure that the escape to DOS
  126. function will find enough room to load a secondary command
  127. processor.  You MAY be able to run some PibTerm functions with
  128. a smaller maximum heap size; this may be useful if you have only
  129. a 256K or smaller machine.  Exit from the O)ptions and use
  130. M to set the Main program to be the file PIBTERM.PAS. Type C
  131. to start the compile.  On a 4.77 8088-based machine, the compilation
  132. takes about nineteen minutes.
  133.  
  134. You should end up with ten files:
  135.  
  136.    PIBTERM.COM
  137.    PIBTERM.000
  138.    PIBTERM.001
  139.    PIBTERM.002
  140.    PIBTERM.003
  141.    PIBTERM.004
  142.    PIBTERM.005
  143.    PIBTERM.006
  144.    PIBTERM.007
  145.    PIBTERM.008
  146.  
  147. To run PibTerm, just enter PIBTERM at the DOS prompt.  You will
  148. be prompted for the creation of a number of necessary configuration
  149. files, unless you use the sample configuration files provided in the
  150. executable version's archive.
  151.  
  152. The various routines for menu construction, file handle I/O,
  153. asynchronous communication, etc. are of use in themselves.  Hopefully
  154. in 35000+ lines of Turbo code, you'll find SOMETHING useful!
  155.  
  156.  
  157. RESTRICTIONS ON USE
  158. ===================
  159.  
  160. You may also make unlimited copies of the program and distribute these
  161. copies as you desire FOR NON-COMMERCIAL APPLICATIONS ONLY,
  162. except that I, Philip R. Burns, reserve the sole right to distribute
  163. the program for profit.  You may request a duplication charge, not to
  164. exceed $12 per copy for the complete source archive
  165. (assuming you need to have two disks to hold the four archive files).
  166.  
  167. You should distribute the program without any changes you have made,
  168. and then a SEPARATE version with any changes you've made.
  169. You should clearly mark the changes in some sort of documentation file,
  170. as well as in the source files you change.  I also suggest that you
  171. add a line to the initial output of PibTerm indicating your name and
  172. the date of your modification.
  173.  
  174. You may use the source code and modify it as you please for
  175. NON-COMMERCIAL APPLICATIONS ONLY.  You may NOT use the code in
  176. developing commercial applications without my permission.
  177.  
  178. I encourage you to extend this program and add interesting
  179. new features.  I also encourage you to upload these changes to
  180. your local BBSs in order to share your work with others.  What I
  181. do NOT want is for you to rip off this code as if it were yours
  182. and sell it for a profit.  That's not nice.
  183.  
  184.  
  185. ADDRESSES FOR ELECTRONIC LETTER BOMBS
  186. =====================================
  187.  
  188. You may leave me messages on the following BBSs:
  189.  
  190.       Gene Plantz's BBS (312) 882 4145
  191.       Ron Fox's BBS     (312) 940 6496
  192.  
  193. Gene's BBS is registration only ($15 a year) and well worth it.
  194. Ron's BBS is essentially open, and also worth calling.
  195.  
  196. Thanks,
  197. Phil Burns
  198. November, 1985
  199.